home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / tshare.arc / TSHARE.DOC < prev    next >
Text File  |  1985-10-25  |  18KB  |  395 lines
  1.                    /=========\
  2.                    | T-SHARE |                (3.6)
  3.                    \=========/    
  4.         
  5.             Marty Ross
  6.             c/o Computing Resource Center
  7.             10801 National Blvd., Third Floor
  8.             Los Angeles, CA  90064
  9.         
  10. Release:    3.6, 10/18/85 with TSHDSKO, TSHDSKO, and TSHPRT
  11. By:            Marty Ross
  12. System:     IBM-PC with standard communications adapter (COM:)
  13. Requirements:    Tested using PC-DOS 2.0/2.1, 128K or larger PC preferred.
  14.  
  15. Abstract:    TSHARE is a demonstration terminal emulator, showing the
  16.         capability of the IBM-PC to multitask, in a practical way.
  17.  
  18. Distribution:    I am distributing this preliminery version freely, in hopes to
  19.         stimulate interest and feedback.  No fee may be charged, and 
  20.         this document must accompany the program(s) documented herein. 
  21.  
  22. Description:    TSHARE is a "background" terminal emulator.  Unlike most 
  23.         terminal programs for the IBM-PC which 'tie up' the computer,
  24.         TSHARE, once activated, can be used simultaneously with almost
  25.         any other application.  
  26.  
  27. Features:    Other than its ability to share the IBM-PC with foreground
  28.         tasks, TSHARE supports a typeahead line turnaround protocol,
  29.         which may be used on many IBM mainframe systems (e.g. VM/SP)
  30.         to enable a 'typeahead' capability.  Also, HALF DUPLEX operation
  31.         may be selected for systems which don't 'echo' characters sent.
  32.  
  33.           Additionally, it is possible to control the effect of incoming
  34.         BELL characters  which usually sound the PC speaker when sent
  35.         to the video monitor.  Many host systems send bells to alarm the
  36.         user on the remote terminal: perhaps a message from another user
  37.         or from the system operator has just been sent and deserves at-
  38.         tention.  TSHARE allows a degree of control over these bells,
  39.         such as ignoring all but the first BELL in a multiple bell 
  40.         sequence, for instance, thus shortening the hideous three BELL 
  41.         sequence of VM/SP's MESSAGE command, etc.  Run-time options
  42.         allow TSHARE to silence incoming bells when in terminal mode, 
  43.         and/or to beep the PC speaker when not in terminal mode and a 
  44.         bell character (pending message) is received.  When using the
  45.         second option, the user can remain offline (doing work in the
  46.         foreground) without needing to occasionally glance into terminal
  47.         mode to see if any pending messages exist; each BELL received 
  48.         from the line immediately causes his speaker to sound, telling 
  49.         him that a message is pending on his terminal.  
  50.  
  51.           With its new device driver facility, TSHARE now has the 
  52.         ability to perform text file UPLOAD and DOWNLOAD in the 
  53.         background, thus freeing up your PC during those lengthy file 
  54.         transfers.  No binary file transfer driver has yet been 
  55.         developed for TSHARE.  As of this release, the only TSHARE 
  56.         drivers are TSHDSKI (TSHare DiSK file-Inject, for DOWNLOAD), 
  57.         TSHDSKO (for UPLOAD), and TSHPRT (send TSHARE console output
  58.         to the printer).  Each driver provides resident code which
  59.         interfaces with TSHARE and performs its specific I/O task.
  60.         For more information on TSHDSKI, TSHDSKO, or TSHPRT, please
  61.         see the discussion below under "Usage".
  62.  
  63.           The last "feature" I will mention really should be standard
  64.         for any terminal program: the ability to transmit a break 
  65.         signal to the host computer (required by many half duplex hosts 
  66.         which cannot watch for control characters like ^C and ^S).
  67.         While in terminal mode, simply hit <Ctl>+<Break>.  If you
  68.         hit <Ctl>+<Break> while NOT in terminal mode then the break
  69.         will not be transmitted to the host, but to your operating
  70.         system, probably causing your program to abort: beware.
  71.  
  72. Files:        TSHARE is distributed in at least two parts: NEW14H.COM, 
  73.         which by itself provides a powerful enhancement to the 
  74.         communication ability of the IBM-PC, and TSHARE.COM, 
  75.         the application component.  Other optional components
  76.         include WKB.COM, the window keyboard enhancement designed
  77.         for use with TSHARE under VM/SP, and future CRC integral
  78.         products.  Files TSHDSKI.COM and TSHDSKO.COM provide disk I/O 
  79.         under TSHARE, allowing the UPLOAD or DOWNLOAD of text files 
  80.         (NOT *.COM, *.EXE, or other files which require a binary file 
  81.         transfer technique).  TSHPRT.COM is similar to TSHDSKO.COM
  82.         in that it will download textual data; TSHPRT sends all console
  83.         output during a TSHARE terminal session to your printer.  
  84.         Finally, in tandem with TSHARE (not a subsidiary program), is
  85.         HOST.COM, which provides a secondary console for your PC by
  86.         using the asynchronous adapter ports COM1: and/or COM2:.
  87.  
  88. Usage:        To use TSHARE or HOST, first install the NEW14H resident driver,
  89.         and initialize the communication port for the desired baud and
  90.         parity settings (the MODE command works well for this).  Then
  91.         invoke the desired driver (TSHARE or HOST) by supplying it any 
  92.         desired options, and the port number you are using.  If no port 
  93.         number specified, COM1 will be used.
  94.  
  95.         In the following example,
  96.  
  97.             A>mode com1:1200,e,7,1
  98.              A>tshare -hvn 2
  99.  
  100.         we want TSHARE with the "H", "V", and "N" options, using COM2 
  101.         set for 1200 baud, even parity, one stop bit.
  102.  
  103.           For more information on HOST, see file HOST.DOC, or if you
  104.         have HOST.COM, simply type "HOST ?", from DOS.
  105.  
  106.           When properly installed, TSHARE can be activated one of two
  107.         ways.  The primary method is to use the Shift-PrtSc key, which
  108.         TSHARE takes over.  This becomes the "toggle" which gets you
  109.         into, and out of terminal mode.  Additionally, TSHARE can be
  110.         activated from the DOS command line by using its "T" option.
  111.         To change transmission settings, such as baud rate, simply
  112.         issue the appropriate DOS MODE command at any time.
  113.  
  114.         TSHARE options:
  115.                 B - Ignore bells when online
  116.                 G - Graphics characters displayed
  117.                 H - Half Duplex. Echo input characters
  118.                 N - Notify if bell & offline
  119.                 M - Turn on missing interrupt handler
  120.                 P - Pass attention through
  121.                 T - Toggle terminal "online"
  122.                 S - Set NEW14H XON/XOFF protocol on
  123.                 Q - Cancel NEW14H XON/XOFF protocol
  124.                 V - VM "typehead" line turnaround
  125.                 _ - Do not change cursor
  126.                 
  127.           I will not go into the details of each here; however, two are
  128.         worth a little discussion.  The "M" option turns on a facility
  129.         which should not be necessary, but should be tried if you exp-
  130.         erience many terminal lock-ups while using TSHARE.  It causes
  131.         the 'interrupt enable register' of your RS232 (modem device) to
  132.         be refreshed each half a second, so that, at most, your terminal
  133.         should only lock-up for a short period.  I don't know exactly
  134.         why the lock-ups occur, but my hunch is that other code in the
  135.         machine is causing interrupts to be lost on COM1: and COM2:. 
  136.         Pressing the <Ctl>+<Break> key, in addition to sending a break
  137.         signal, also performs this same function, so that you can 
  138.         recover from a locked terminal even when the "M" option was not
  139.         specified.  Another TSHARE option worth note is the "P" option
  140.         which may not have an obvious effect: it causes your [PrtSc] key
  141.         to activate not only TSHARE, but whatever existed as a function
  142.         of that key before TSHARE was activated.  For instance,  WKB or
  143.         HOST can be toggled on/off in tandem or simultaneously with 
  144.         TSHARE with proper use of this feature.  If you use this option
  145.         when no other TSHARE related drivers are installed, then the 
  146.         Print-Screen function will occur whenever TSHARE is switched on
  147.         or off (using the [PrtSc] key).
  148.  
  149.           After TSHARE is installed and with a connection established, 
  150.         the program TSHDSKI.COM can be used to transnmit a disk file
  151.         over the communications line.  The UPLOAD, as this is referred
  152.         to, happens as though the file specified was typed directly into
  153.         your terminal keyboard, therefore binary files may not transfer
  154.         correctly.  The program TSHDSKO.COM can be used to create a copy
  155.         of your terminal session on a disk file, while TSHPRT.COM will
  156.         route a copy to your printer.  Both of the latter programs pro-
  157.         vide the ability to DOWNLOAD text files.  Formal .DOC for 
  158.         TSHARE drivers is not provided here; invoking the driver with
  159.         a question mark as the only argument will provide help.
  160.  
  161.           To refresh your memory after learning about TSHARE, or for
  162.         complete syntax rules for activating TSHARE, type "TSHARE ?"
  163.         in DOS for a help screen.  The same applies to all the other
  164.         TSHARE drivers (as mentioned above), and the NEW14H program.
  165.         
  166.  
  167. Installation;
  168.   A Summary:
  169.           There are four steps necessary to activate TSHARE so that
  170.         it may be used as a terminal emulator:
  171.  
  172.             1.)  Initialize PC-DOS
  173.             2.)  Install the NEW14H communication enhancements
  174.             3.)  Install the TSHARE application component
  175.             4.)  Initialize the COM: port for desired baud/parity
  176.                  (TSHARE DOES NOT DO THIS: USE PC-DOS "MODE.COM")
  177.  
  178.         A typical installation sequence (which can be combined into
  179.         a .BAT file, such as "AUTOEXEC.BAT"):
  180.  
  181.  
  182.         +---------------------------------------------------------+
  183.         |                              |
  184.        (1)    |    <ALT>+<CTL>+<DEL> ...                  |
  185.         |                              |
  186.         |    IBM Disk Operating System              |
  187.         |    Version 2.xx ...                  |
  188.         |                              |
  189.        (2)    |    A>new14h                      |
  190.         |    New14H - 2.x - (C) Copyright 1985, by Marty Ross  |
  191.         |    Auxiliary COM1: port driver active.          |
  192.         |                              |
  193.        (3)    |    A>tshare                      |
  194.         |    TSHARE - 3.x - (C) Copyright 1985, by Marty Ross  |
  195.         |    (Using NEW14H ver 2.x)                  |
  196.         |                              |
  197.        (4)    |          A>mode com1:300,n,8                  |
  198.         |                              |
  199.         |    A>rem TSHARE can now be "called up" anytime until |    
  200.         |    A>rem we re-boot (CTL+ALT+DEL), by pressing       |
  201.         |    A>rem '<SHIFT>+[PrtSc]', unless another program      |
  202.         |    A>rem redefines our interrupts.              |
  203.         |                              |
  204.         +---------------------------------------------------------+
  205.                     Figure 1.
  206.     
  207.       Notice that after running the TSHARE program, we came back to DOS.
  208.     To reiterate, TSHARE works in the background, and is transparent to
  209.     the DOS user, until he switches into terminal mode.  From any 
  210.     subsequent environment[1], terminal mode may be entered by pressing
  211.     the <SHIFT>+[PrtSc] keys together[2].  For example, while assembling
  212.     a lengthy program using the Macro Assembler, if TSHARE is active, 
  213.     press <SHIFT>+[PrtSc], and initiate a terminal session:
  214.  
  215.         +---------------------------------------------------------+
  216.         |                              |
  217.                |    A>masm myprog                      |
  218.         |    Object file [MYPROG.OBJ]:              |
  219.         |    Listing file [NUL]:                  |
  220.         |    Cross Reference [NUL]:                  |
  221.         |                              |
  222.             |    T-Share: ON COM1:                  |
  223.         |                              |
  224.         |    AT TD 1-213-829-1487                  |
  225.         |    CONNECT                          |
  226.         |                              |
  227.         |    VM/370 ONLINE                      |
  228.         |                              |
  229.         |    ._                          |
  230.         |                              |
  231.         +---------------------------------------------------------+
  232.                     Figure 2.
  233.         
  234.       First, we started our foreground task (the assembler), then we
  235.     switched into terminal mode by pressing <SHIFT>+[PrtSc].  TSHARE
  236.     indicated our terminal status, and immediately placed us online
  237.     (in example, to a Hayes Modem), from where we can start/continue
  238.     our current terminal session.  
  239.  
  240.       Note that if the foreground task sends output to the screen, it will
  241.     be interleaved with our terminal output.  In future versions, it may 
  242.     be possible to re-route, ignore, or accumulate foreground output.
  243.     It would be easy to implement a split-screen where a given portion
  244.     of the screen would be 'dedicated' to terminal output, while the rest
  245.     will display the output from the foreground task (see 'Directions:').
  246.  
  247.       If we switch back to the foreground task (get out of terminal mode)
  248.     before concluding our terminal session, then any data which comes in
  249.     over the communication line is saved (because of NEW14H interrupt
  250.     facilities: up to 32K of data), and will be quickly displayed by
  251.     TSHARE, until it is 'caught up' with the incoming data.  To freeze
  252.     the fast display of buffered data, use <Ctrl>+<S>.  Any character
  253.     will cause the listing to resume.  
  254.  
  255.       In order to transmit a break signal (approx 500 millisecond MARK
  256.     state), while in terminal mode only, use the <Ctrl>+[Break] key
  257.     pair.  In terminal mode, this action does not affect the foreground 
  258.     task.
  259.  
  260.  
  261. Why TSHARE?:    TSHARE was written because I do alot of compilation using
  262.         a good, but slow compiler.  I purchased a COM1: port in order
  263.         to facilitate my interaction with our large computer at work,
  264.         only to find that I really needed an extra terminal for use
  265.         when my PC was busy churning away on my programs.  I found it
  266.         unforgivable that none of the other popular terminal programs
  267.         would use the (almost) wonderful multi-tasking capabilities of
  268.         the IBM-PC, and therefore my investment in additional hardware
  269.         was less attractive because I couldn't use it most of the time!
  270.  
  271.           By using the communication interrupts (NEW14H) and a simple
  272.         byte multiplexor scheme (attached to the PC-BIOS timer INT 8), 
  273.         TSHARE, once installed, has effective control over the com-
  274.         munication line even while other programs are running.  
  275.  
  276.           For example, I leave my PC connected to the mainframe during 
  277.         the day using TSHARE's "notify" option, which rings my PC's
  278.         speaker if someone sends me a message (a bell character) 
  279.         from the mainframe.  Though I may be in an editor, or waiting
  280.         for a compiler, I can easily toggle into TSHARE, read the
  281.         (still pending) message, and respond to the sender -- my PC
  282.         keeps right on with what it was doing in the meantime.  Any
  283.         data received on the line is continuously buffered until you
  284.         switch into terminal mode so that you don't miss anything.
  285.  
  286.  
  287. Future        Future versions of TSHARE will necessarily incorporate a
  288.   Directions:    file transfer protocol; perhaps XMODEM.  Also, ANSI emulation
  289.         is on the agenda since full-screen support over low speed lines
  290.         will shortly be available for our VM/SP system.  Thus, IBM
  291.         3270 style communication or other formatted screen support
  292.         will be possible.  Alternatively, a terminal window can
  293.         be used so that both foreground and background tasks can
  294.         be monitored on the same screen, without confusion, as may
  295.         result with this version's scheme of interleaving both
  296.         terminal and foreground output.  
  297.  
  298.           Also, with TSHARE's communication system, it would be 
  299.         relatively easy to create pop-up shingles (boiler-plates,
  300.         menus, status reports, etc) to allow modification of TSHARE
  301.         settings.  Currently, these functions must be done from the
  302.         DOS command line, thus decreasing the ability of TSHARE to
  303.         work completely in the background.
  304.  
  305. Disclaimer:    Though I've tested TSHARE under varying conditions, I cannot
  306.         guarantee that TSHARE will work in every case/PC configuration.
  307.         Also, I suggest you use caution when using TSHARE in new
  308.         situations (foreground programs, etc): I will not be liable
  309.         for any damage caused, but would like to be informed if any
  310.         undesireable TSHARE interactions occur.  Please write me.
  311.  
  312. About the Author:
  313.  
  314.         Marty Ross is a consultant for the Computing Resource Center,
  315.         a data processing firm in Los Angeles.  CRC uses the IBM VM/SP
  316.         operating system to provide its clients with an interactive
  317.         method to access popular mainframe data handling facilities, 
  318.         such as SAS, PL/1, FORTRAN, and the On-Line Data System, 
  319.         CRC's own database management product.  For microcomputers,
  320.         CRC has released a Statistics/Data Analysis and Graphics
  321.         package for the IBM-PC called STATA, the Data Tool, which 
  322.         features standard statistical (regression) analyses, excellent 
  323.         data handling capabilities, and a wide variety of experimental
  324.         data analysis techniques with STATA/Graphics.  If you are 
  325.         interested in obtaining a DEMO copy of STATA, please call CRC
  326.         on their toll-free number:  1-800-782-8272 outside California,
  327.         or dial them directly at (213) 470-4341.  Be sure to tell them
  328.         that Marty sent you!
  329.  
  330.  
  331. ----------------------------
  332.  
  333. [1]  NEW14H, and therefore TSHARE will be destroyed by programs such as BASIC 
  334.      or BASICA which re-define the communication interrupt driver(s).  Also,
  335.      only "nice" programs which do not 'steal' the keyboard, video, PrtSc,
  336.      or timer interrupts may be used successfully with TSHARE.
  337.  
  338. [2]  Perhaps it is unfortunate that TSHARE uses the <SHIFT>+[PrtSc] key
  339.      thus disabling it as a "print screen" function.  Remember, however;
  340.      this is only a demonstration program and was not written with profes-
  341.      sional intent.  If enough interest is shown, future versions will 
  342.      be released to those contributing new ideas, free of charge.
  343.  
  344. -----------------------------
  345.  
  346.                    /=========\
  347.                    | T-SHARE |                (3.6)
  348.                    \=========/
  349.         
  350.             Marty Ross
  351.             c/o Computing Resource Center
  352.             10801 National Blvd., Third Floor
  353.             Los Angeles, CA  90064
  354.  
  355.                 Comments?   
  356.                 Can you use TSHARE?  
  357.  
  358.  
  359. Name:       _________________________________________________________
  360.  
  361.  
  362. Address:    _________________________________________________________
  363.  
  364.             _________________________________________________________
  365.  
  366.             _________________________________________________________
  367.  
  368.         _________________________________________________________
  369.  
  370.             _________________________________________________________
  371.  
  372.             _________________________________________________________
  373.  
  374.             _________________________________________________________
  375.  
  376.             _________________________________________________________
  377.  
  378.             _________________________________________________________
  379.  
  380.             _________________________________________________________
  381.  
  382.  
  383.     If you feel TSHARE contributes to your effectiveness, then please let
  384.     me know by sending a donation of $10.00 or whatever you feel is ap-
  385.     propriate.  TSHARE was developed in my spare time, and is now not a
  386.     commercial effort of CRC.  I will continue to develop products like
  387.     TSHARE for those who show interest - provided I can afford it.  Users
  388.     who make contributions will be entitled to a single sided diskette
  389.     of other PC-DOS utilities I've developed while at CRC: please include 
  390.     your name and return address when sending donations!
  391.  
  392.     P.S. -  If its the $10.00 that keeps you from filling this out, forget
  393.         about the money, it's the feedback I really want.
  394.  
  395.